DOS 
HANDOUTS 



PDP-il DISK OPERATING SYSTEM SOFTWARE (DOS) 

This course is designed to teach the student how to: 

1 . Generate a Disk Operating System from DECtape or paper tape. 

2. Write, run, and modify programs using programmed monitor requests and the 
DOS software programs. 

3. Communicate with the system by means of keyboard commands. 

LENGTH: 5 Days 

PREREQUISITES: The student must be thoroughly familiar with the PDP-1 1 instruc- 
tion set and programming techniques, and the following PDP-1 1 paper tape software 
programs: Assembler (PAL-11), Text Editor (ED-11}. On-line Debugging Technique 
(ODT-1 1 ), Extended On-line Debugging Technique (ODT-1 IX), Core Memory Dumps 
(DUMPTT) (DUMPAB), Input-Output Executive (lOX), Floating Point Math Package 
(FPP-11). Formal training in these areas can be obtained by attending any of the 
following courses: PDP-1 1 PAPER TAPE SOFTWARE (STANDARD), PDP-1 1 PAPER 
TAPE SOFTWARE (ACCELERATED), or PROGRAMMING THE PDP-1 1 . 
CONTENT: This is designed to be a user course, and does not present a detailed 
examination of the DOS monitor. It contains an overview of the monitor program 
and file structure, and covers the use of programmed monitor requests, keyboard 
commands, and the following DOS software programs: BATCH-11, MACRO-11 As- 
sembler, Text Editor (EDIT-1 1 ), Relocatable On-line Debugging Technique (ODT-1 1 R), 
Linker (LI NK-11), Librarian (LIBR-11), File Utility Program (PIP), and system gener- 
ation (CILUS, SYSLOD, ROLLIN). A portion of the course time is allotted to super- 
vised laboratory sessions. 
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END OF PERMANENT MONITOR 

END OF BUFFER AREA 

LAST ADDRESS IN AVAILABLE CORE 

PROGRAM LOAD ADDRESS 

SYSTEM CONFIGURATION INDICATORS 

BIT CLOCK CYCLE INDICATOR, USED BY C 
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BIT 6 CLOCK TYPE INDICATOR 
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BIT 13 SYSTEM LOAD BIT 

LOAD = 1 OTHERWISE = 
BIT 14 PRIVILEGED USER BIT 

BIT 15 AC INDICATOR, USED BY BATCH SYSTEM 
POINTS TO DYNAMIC ASSIGNME NT TABLE 
CHAIN OF INITIED DDBS 
MONITOR USER SWITCH 
OTHER SWITCH 
PROGRAM START ADDRESS 
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POINTER TO MAIN SWAP AREA 

STACK BASE (BASE + 2) 

SCRATCH UIC 

KEYBOARD POINTER 

CIL BASE 
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The resulting format of the DDL is illustrated at Page 8. 
The significance of each item is as follows: 

1. Device name - is the radix-50 form for the alphanu- 
meric code assigned to each device. The only way 
an entry in the list can be found is by a search. 
This item therefore enables its identification. 

2. Core load address - contains the start of the dev- 
ice driver when in core. Otherwise indicates the 
driver's current non-residency. 

3. Interrupt vector address - is the start address of 
the two-word vector assigned to the device within 
memory locations 0-377 (or as otherwise provided) 
and is needed to permit the linkage of the driver's 
interrupt service routine to the vector when load- 
ed. (See Section 3.2.1) it is held within the DDL 
rather than the driver itself, because the user can 
physically reassign devices to different vectors. 
This obviates reassembly of the driver and also al- 
lows in-core modification, even though the driver 
at the time is available only in the external Moni- 
tor Library. 

4. System-device start block - gives the actual device 
address for the driver within the Monitor Library. 
As for the MRT, no driver is expected to start bey- 
ond block #1777(8) . 

5. # of 16-word blocks - enables determination of the 
size of the driver for claiming and releasing the 
buffer it occupies while in core and for specifying 
of # of words to be read, in order to perform the 
necessary load (see Section 3.2.1). The six-bit 
capacity of the field allows a maximum driver 
length of IK, which is more than ample in most 
cases. 

6. DDL end - replaces the external address data in the 
system-device entry in the table since the latter 
information is irrelevant when, by its purpose, the 
driver for such device can never leave memory. The 
provision of this item instead allows the DDL to be 
of variable size and hence contain only the drivers 
needed to support the particular configuration be- 
ing used. However it is essential that the system 
device entry is alway the first in the DDL as shown 
in the diagram. 
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(currently unused) 



Fig. 4-3; Master File Directory Block #1 



LirK TO NEXT MFD BLOCK (or 0) 
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POINTER TO UFD START BLOCK 
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USER IDENTIFICATION CODE 




POINTER TO UFD START BLOCK 


1 


# OF WORDS IN UFD ENTRY 
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USER #2 



Fig. 4-4: Master File Directory Block #2 
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FILE 

NAME 
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FILE 
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FILE 
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FILE 
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FILE 
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LINK TO NEXT MAP BLOCK 
MAP # 
# OF WORDS OF MAP W 
LINK TO FIRST MAP BLOCK 



MAP FOR BLOCKS 0-17 

- " - 20-37 

- - - 40-57 

- " - 60-77 

- " - 100 - 117 

- •* - 120 - 137 
10 - 

160 - 177 

200 - 217 
210 - 237 

etc. 
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Bit-map Segment Format 
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Protection Code Format 
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Block #1046: 
( START ) 
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Block #1064: 
(FINISH) 
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DATA 
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DATA 
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Block #7352: 



Block #7 35 3: 



Block #7354 



Block #7 355 



DATA 



DATA 



DATA 



DATA 



Block #7356 



Block #7357 



DATA 



DATA 



Linked File Format. 



Contiguous File Format, 
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(Reserved for Bootstrap) 



MFD BLOCK #1 



USER #1 - UFD #1 



USER LINKED FILES 
OTHER UFD BLOCKS 



USER 

CONTIGUOUS 

FILES 



MFD BLOCK #2 



BIT MAP BLOCK #1 



BIT MAP BLOCK ^n 



BLOCK 

1 
2 
3 
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Protect"-^ 
Line 
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SYSTEM BOOTSTRAP :^^ 



MFD BLOCK #1 



SYSTEM UFD BLOCK #1 



SYSTEM UFD BLOCK #2 



MONITOR 
LIBRARY 



SYSTEM PROGRAMS 
USER LINKED FILES 

Sc 

OTHER UFD BLOCKS 



USER 

CO\TIGUOUS 

FILES 



SYSTEM 
u th PHOGRAM 
i-V^^'*^*^ OVERLAYS 



MFD BLOCK #2 p^^^' :itt]^tBM 



BIT MAP BLOCK #1 



BIT MAP BLOCK #n 



Non-syRtem Disii Format 



System Disk Format 



(7. 



QwtM ?t UAil^^-^ f'' 
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iirs 
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(Reserved for Bootstrap) 



USER 
LINKED 
FILES 



USER 
LINKED 
FILES 



FILE MXPSi 1-7 



8-14 



I 



15 - 21 



22 - 28 



29 - 35 



36 - 42 



43 - 49 



•B ** . 



50 - 56 



MFD BLOCK #1 



MFD BLOCK #2 



UFD BLOCK #1 



UFD BLOCK #2 



MASTER BIT MAP 



USER 

LINKED 

FILES 



USER 

CONTIGUOUS 

FILES 



Block #7flri- 
(36-vord 
entries) 
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Block #18r2i- 
( 9-word 
entries) 



FILE #1 BIT-MAP 



FILE #2 BIT-MAP 



FILE #7 BIT-MAP 



-SSEEL 



(Link to #1^3) 



FILE #1 ENTOY 



FILE #2. ENTRY 



FILE #3 ENTRY 



FILE #4 ENTRY 



FILE #5 ENTRY 



FILE #6 ENTRY 



FILE #7 ENTRY 



FILE #8 ENTRY 



FILE #25 ENTRY 



FILE #26 ENTRY 



FILE #27 ENTRY 



FILE #28 ENTRY 



-(Spare) 



Fig, 4-11 1 DECtape Format 
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DOS MACRO- 11 

I. General Assembler Directives 

A. Listing Control Direc tives 
1. .LIST a-ti: 



2. .NLIST arg 




Arguments : 


Controls listing of: 


SEQ 


source line sequence numbers 


LOC 


location counter 


BIN 


Binary output 


BEX 


binary extensions of instructions 


SRC 


Source code 


COM 


comments 


MD 


macro definitions and repeat 




range expansions 


MC 


macro calls and repeat range 




expansions 


* ME 


macro expansions 1 


* MEB 


macro expansion binary code 


CND 


unsatisfied conditions, .IF 




and .ENCX: statements 


* LD 


lis4:ing directives without 




arguments 


TOC 


table of contents on assembly 




pass 1 


TTM 


listing output format 


SYM 


sifmbol table for the assembly 


*Default = NOLIST 





3. Switches on the listing file specification 
during assembly: 

/LI: arg 
/NL arg 

B. Page Headings 



1. 
2. 
3. 

A 



TITLE 
. SBTTL 
. I DENT 



I'}. 



C. Functions 



1. 


.ENABL arg 


2. 


.DSABL arg 


..-. 


- -- ■ T 


Arguments 


ABS 




AMA 




CDR 




FPT 




LC 




LSB 




PNC 




3. 


Switches: 




/EN: arg 




/DS: arg 



Description 



outputs in absolute binary 

converts all mode 67 's to 37 

columns 7 3'^' are treated 

as comments 

causes floating point truncation 

accepts lower case and converts 

to upper case 

enables or disables a local symbol 

block 

enables or disables binary output 



D 



Data Storage 



1. 


.BYTE 


2. 


.WORD 


3. 


1 


4. 


II 


5. 


.ASCII 


6. 


.Ascrz 


7. 


.RAD50 



E 



Radix Control 



1.. .RADIX 

2. t^D 

3. fO 

4. tB 

Location Counter Control 

1 . . EVEN 

2 . . ODD 

3 . . BLKB 

4 . . BLKW 



G 



Numeric control 



1. .FLT2 

2. .FLT4 

3. fF 

4. fC 



H 



Terminating Directives 



1. .END 

2 . . EOT 



ao. 



I. Program Boundaries 

1. .LIMIT 
J. Program Sectioning 

1. .ASECT 

2. .CSECT 

3. .CSECT Symbol 

K. Symbol Contol 

1 . . GLOBL 
L. Conditional Assemblies 
1. IF . . . 
II. MACRO Directives 

A. MACRO Definition 

name, dummy arg 



1. 


. MACRO nam< 


2. 


.ENDM 


3. 


.MEXIT 


4. 


MACRO calls 


5. 


Concatenation 


6. 


.NARG 


7. 


.NCHR 


8. 


.TYPE 


9. 


.ERROR 


10. 


. PRINT 


11. 


.IRP 


12. 


.IRPC 


13. 


.REPT 


14. 


.MCALL 



Al 
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1 

a 

4 

I' 

-7' 
it 

IB 
16 
17 

iS 

a0 

82 



23 
84 
25 
26 
27 
28 
29 

3ia 

31 
32 



.TITLe OEMO 



33 
34 

35 

36 
37 

38 

39 

40 
41 
42 
43 



00 000 

00000 



00004 
00004 

00010 
00012 
00014 



00016 
00016 

00022 

00026 

00032 



000000 


R0« 


%0 


000001 


Rl« 


XI 


000002 


H2» 


%2 


000003 


R3» 


13 


000004 


R4« 


%4 


000005 


R5« 


XS 


000006 


3P« 


Xd 


000007 


PC« 


X7 



LI3T MEB 



;SIMptIFY INSTRUCTION 

.MACRO CALL 
,QLQ8L ADOR 
JSR PC^AOOR 



JLIST MACRO EXPANSIONS OF LINES 
rWMICH GENERATE BINARY CODE 



ADDR 



004767 
000000G 



CALL 

asR 



SUBR 
PCSUBR 



> HANDLE ARGUMENT LISTS 



mA767 
0000006 
000001 
000002 

000003 



.MACRO 

.GL06L 

JSR 

ri*10RD 

»CNOM 

FUNCT 
JSR 



ARGlf 



FUNCT 
SUBR 
PC, SUBR 
ARGl# ARG2, 



ARG2, 
ARG3 



ARS3 



1 f 2 r 3 

PC, SUBR 



•WORD X, 



2, 



?THIS COULD BE REDEFINED AT A LATER DATE TOl 



i?l2746 
0550006 
012746 
000005 
012746 
000004 
104410 



•HACRO FUNCT ARGl, 

MOV #ARG3#«CSP) 

HOV #AR62i»CSP) 

MOV #ARGl#»(SP) 

TRAP 10 
♦ ENDM 

FUNCT 4f5i6 

MOV JI<6,»CSP) 

MOV #5,*CSP) 

HOV ^4,-CSp) 

TRAP 10 



ARG2| ARG3 



5.^. 



lEhO 



'ij^'^^^jyi 
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?ESTA8LISH OEFAI 


JLT VALUES WHICH CAN BE 


3 

4 




?OVER-RIDDEn In 


A pakeheter file 




rHACRO 


PARAH MNE, VALUE 







• JIF NOF mt, MNE» VALUE 


a 




• LIST 


f FORCE LISTING OF FINAL VALUE 


; ^-' ' 




MNE» ;MNE 




f 




,NLI5T 




9 




,ENOM 




10 








U 00034 




PARAH 


ALPHAr 1000, 




001750 


ALPHAi ALPHA 




12 








13 


000200 


BETAi 200 




14 00034 




PARAM 


BETA, 120 




000200 


3ETA» BETA 




15 








16 




^GENERATE MESSAGE 


17 








1« 




, MACRO 


GENMSG STRING,. ?LABEL 


19 




.WORD 


LABEL-, -2 


20 




, ASCII 


^string^ 


21 




• LIST 


ILIST FOR EXAMPLE 


22 




LA8ELI .EVEN 




23 




•NLIST 


> RETURN TO NORMAL LEVEL 


24 




• ENDH 




25 








ae 00034 




GENHSG 


<NOW IS> 


00034 


000005 


.WORD 


64$-, -2 


00036 


116 


•ASCII 


ONOW ISO 


00037 


117 






00040 


127 






0«041 


040 






00042 


ill 






00043 


123 






00044 




64$ 8 .EVEN 




27 








28 




•MACRO 


GENMSG STRING#LABEL 


29 




•ASCIZ 


OSTRINGO 


30 




• EVEN 




31 




• ENDM 




32 








.33 00044 




GENMSG 


<THE TlME> 


00044 


124 


•ASCIZ 


OTHE TJMEO 


00045 


110 






00046 


105 






00047 


040 






00050 


124 






00051 


in 






00052 


116 






00053 


105 






00054 


000 







as. 
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I .UCRO ,PAf?AM 

3 «is%Aui 

4 R2»%a02 

g R3f%A03 

6 R4«Xa04 

7 RS«Xa05 

8 R6B%An6 

9 R7«%a07 

10 3P«%a06 

II PC«%a07 

\2 PSH'i^0X7777e 

i3 SWR«Ani77570 
i4 ^ ,ENDM 

15 eMACRC ,IMT ,LBLCK 

16 •HCALL .AMODE 

17 .AHODE .IBLCK 

18 EMT <a06> 

19 .ENDM 
20 

21 .MACRC ,RL9E .LBLCK 

22 .MCALL .AMOOE 

23 ,AMOOE .LBLCK 

24 EMT <A07> 

25 ,ENDM 
26 

27 .MACRO .CLOSE .LBLCK 

28 .HCALl .AMODE 

29 .AMODE .LBLCK 

30 EMT <A017> 

31 .ENOH 
32 

33 .MACRO .READ .LBLCK^ .LiUFF 

34 , MCALL .AMODE 

35 .AMOOF .LBUFF 

36 .AMODE .LBLCK 

37 EHT <A04> 

38 ,ENDM 
39 

40 .MACRO .^RITE .LBLCK, , LBUFF 

41 .MCALL .AMODE 

42 .AMODE .LeUFF 

43 .AMODE .LBLCK 

44 EMT <A02> 

45 .ENDM 
46 

47 .MACHO .nPENO . LtJLCKi , FBLCK 

48 .MCALL .C00E#.OPEN 

49 .CODE .FBLCK,<a02> 

50 .OPEN . LBLCK,, FBLCK 

51 .ENOM 
52 

53 .MACRO .OPENI , LBLCK, . FSLCK 

54 .MCALL .CODEf.OPEN 

55 .CODE .FBLCK, <An4> 

56 .OPEN .LBLCK, .FBLCK 
b7 .ENDM 
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58 
59 
50 
61 
52 
53 
54 
55 
66 
67 
65 
69 
70 
71 
72 
73 
74 
75 
76 

11 

78 

79 
80 
81 
82 
83 
64 



.MACRO 
.MCALL 

• CODE 
.OPEN 

• ENDM 

.MACRO 

•MCALL 

.CODE 

.OPEN 

.ENDM 

.MACRO 
.MCALL 

• CODE 
.OPEN 

• ENDM 



.OPENU .LBLCKf .FBLCK 
.COOE^.OPEN 
.FBLCK,<a01> 
.LBLCK,.FBLCK 



.OPENC .LBLCK^.FBLCK 
.CODEi.OPEN 
.FBLCK,<a013> 
,LBLCK,,rBLCK 



.OPENE .LBLCKf .FBLCK 
.CODE#,OPEN 
.FBLCK,<a03> 
.LBLCK,.FBLCK 



, MACRO gOpEN 
•HCALL IamODE 
.AMODE .FBLCK 
.AMODE .LBLCK 
EMT <A016> 
.ENDM 



-IBl CK. -FRLr.K 



AS. 
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1 

Z ,MACKn ,.fAlT •LbLCK 

3 •HCALL ,AHODE 

4 •AMOOE .LBLCK 

5 £HT <AQ1> 

6 .ENDM 
7 

8 .HACRO .WAITR .LBLCK^.AODR 

9 .MCALl .AMODE 

10 .AMOOE ,AODR 
U ,AMODE .LBLCK 

12 CHT <aOP!> 

13 .ENDM 

1^ 

l§ , MACRO ,flLOCK ,LBLC»^^,BBLCK 

16 .^CALL .AMODE 

17 .ANiODE .331CK 

18 ,Af^ODE .L8LCK 

19 EHT <A01l> 

20 .ENOM 
21 

22 .MACRO .IRAN .LBLCK, , TBLCK 

23 .MCALL .AHODE 

24 .AMOOE .TBLCK 

25 .AMODE .LBLCK 

26 EMT <AO10> 

27 ,ENDM 
28 

29 .:iACRO .SPEC .LBLC<,,SARG 

30 .HCALL , AMODE 

31 .AHOOE ,SARG 

32 .AMODE .LBLCK 

33 E^iT <A012> 

34 .ENOM 
35 

36 ,"4ACR0 ,STAT .LBLCK 

37 .HCALL .AHODE 

38 .AMODE .LBLCK 

39 EMT <a013> 

40 .ENDM 
41 

42 .MACRO .ALLOC .LBLCK, ,FBLCK, .N 

43 
44 
45 
46 
47 
^8 
49 
50 .MACRO .OELET .LBLCK, ,FBLCK 

51 
52 
53 

54 
55 
56 

57 .MACRO .^E^iAM . LBLCK ,, OFH, , ^pn 



.MACRO 


.ALLOC 


.MCALL 


.AMODE 


.AHODE 


.M 


.AMODE 


.FBLCK 


.AMODE 


.LBLCK 


l,^^ <A0i5> 


• ENOM 




.MACRO 


.OELET 


.MCALL 


.AMODE 


.AMOpF 


.FBLCK 


.Ar^ODE 


.LBLCK 


E^n <A02l> 


.ENDM 
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88 •^CALL .AMOOE 

59 •AMOOE ,MFB 

60 .AMODf- .OFB 

61 .AMODf ,UBUCK 

62 EHT <aO20> 

63 ,ENOM 



;i7. 



,HAc«n 


.APPND 


•HCALL 


.AMODE 


.AHODE 


,2F8 


,4H00E 


• IFB 


,AHODE' 


,LBLCK 


EMT <A022> 


,ENDM 
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I 

2 ,HAC«n ,&PPND .LBLCK#,iFB,,2FB 

3 
4 
6 
6 

6 

9 

10 .MACRO .LOOK .LBLCK^.FBLCK^.OP 

il ' .MCALU .AMODE 

12 .AMOOe .FBLCK 

13 .IIF N8,,0P,CLR -CSP) 

14 ^ .AHOOE .LBLCK 

15 EMT <A014> 

16 .ENDH 
X7 

18 .HACRC .KEEP .LBLCKi .FSLCK 

19 .HCALL , AMODE 

20 .AHODE .FBLCK 

21 .AMODE .LBLCK 

22 E-'^T <A024> 

23 .ENDM 
24 

25 .MACRO .EXIT 

26 EMT <AO60> 

27 .ENDM 

28 

29 .MACRO .TRAP .$TUS,.ADOR 

30 .MCALL .AMODE 

31 .AMOOE ,AODR 

32 .AMODE .STUS 

33 MOV #A01,-CSP) 

34 EHT <a041> 

35 .ENDM 
36 

37 .MACRO .STFPU ,STUS,.ADDR 

38 .MCALL .AMODE 

39 .AMODE .ADDR 

40 .AMODE .STUS 

41 MOV #A03,«CSP) 

42 EMT <AQ41> 

43 tENOM 

44 

45 .HACRO .t^ECRD .LBLCK, .HBLCK 

46 -MCALL .AMODE 

47 .AMODE .RBLCK 

48 .AMODE .LBLCK 

49 EMT <a025> 

50 .ENDM 

51 

62 .MACRO .DUMP .LOW, .HIGH, .COE 

53 
54 
55 
56 
57 



.MACRO 


.DUMP 


.HCALL 


.AMODE 


.AMODF 


.LOW 


.AMODE 


.HIGH 


.AMODE 


.CDE 


EMT <a064> 
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66 .ENDH 
59 

60 .MACRO .RSTRT ,AOOR 

61 f'^CAUL .AHOOE 

62 .AMOOF ,ADDR 

63 MOV #A02,-C8P) 

64 EHT <AQAX> 

65 .ENDM 
66 

67 .MACRO .CORE 

68 MOV #AOl00r«(SP) 

69 EMT <A04l> 

70 .ENDM 

71 

72 .MACRO .HONR 

73 MOV #AO101,-(SP) 

74 EHT <a041> 

75 .ENDM 
76 

78 MOV tfAOl^a^-CSP) 

79 EHT <A041> 
60 ,£NDM 

61 

62 .MACRO .DATE 

83 MOV #AO103,«C8P) 

84 EMT <A041> 

85 .ENDM 
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i 

2 , MACRO ,TlHt 

3 MOV #A0ia4,-.(SP) 

4 E-MT <a041> 
g ,ENOM 

(> 

y .MACRO .GTUIC 

8 HOV #AO10S,-CSP) 

9 £HT <a041> 

10 ,ENDM 

u 

12 .MACRO ,?Y80V 

13 MOV #A01<36,-CSP) 
|4 " £MT <A041> 

l5 ,ENOM 

Ifi 

17 .MACRO .RADRK ,AODR 

10 .HCALL .AHODE 

19 .AMODE ,AOOR 

20 CLR •CSP) 

21 £MT <a042> 

22 ,ENDM 
23 

24 .MACRO .RADUP ,ADOR,.WRD 

25 .MCALL .AMODE 

26 .AMOOE .WRD 

27 .AMODE ,AOOR 

28 MOV fAOli-CSP) 

29 EMT <A042> 

30 ,ENDM 

31 

32 .MACRO .028IN .ADDR 

33 .MCALL .AMODE 

34 .AMODE .ADDR 

35 MOV #A02,-(SP) 

36 EMT <A042> 

37 .ENDM 
38 

39 
40 
41 
42 
43 
44 
45 

46 
47 

48 
49 
50 
51 
52 
53 
54 
55 
56 
57 



.MACRO 


,8IN20 ,ADOR,.WRD 


.MCALL 


.AMODE 


.AMOOE 


,WRD 


.AMODE 


.ADDR 


MOV 


tfAQS^-^CSP) 


EMT <A042> 


• ENDM 




. lACRO 


.02BIN .ADDR 


.MCALL 


.AMODE 


.AMODE 


.ADDR 


MOV 


rtA04,-(SP) 


EMT <AQ42> 


• ENOM 




.MACRO 


,f^IN20 ,ADOR,,WRD 


•MCALL 


.AMODE 


.AMODE 


.WRD 


.AMODE 


.ADDR 
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68 
69 
66) 



MOV «A05,-(vSP) 
fe'MT <AQa2> 

• ENDM 
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I 

2 t'UCRD ,CSII »C^^dF 

3 .HCALL ,4^noE 

4 ,4H0DF ,CHD8F 
g EMJ <a056> 
a fENDM 

7 

8 .MACRO ,CSI2 .C8BLK 

9 .HCALL .AMODE 

10 ,AMODE .CSBLK 

11 EMT <A057> 

12 ,ENOM 

i3 

|4 ,NACRO .DTCVT .ADOB 

15 .MCALL .CVTOT 

16 .CVTDT tfAO0,,ADDR 

17 .ENDH 
18 

19 .MACRO .TMCVT ,ADOR 

nn Mr A I I , r uTnT 

21 .CVTDT #A01,.A00R 

22 .ENOM 

23 

24 .MACRO .CVTDT .CDEt .AODRi . VALl » , VAL2 

25 

26 
27 

28 
29 

30 
31 
32 
33 
34 
35 
36 

37 .^ACRO .GTPL* 

38 CLR -CSP) 

39 MOV #A05^-CSP) 

40 E^T <a041> 

41 .ENDM 
42 

43 .HACRO .STPLA .ADOR 

44 .HCALL .AMODE 
46 .AMOOE .ADOR 

46 MOV #AC5,-CSP) 

47 EMT <a041> 

48 .ENDM 
49 

50 .MACRO .GTCIL 

51 MOV #A0Ul»-CSP5 

52 tM <a041> 

53 .ENOM 

54 

55 .MACRO ,^,TSTK 

56 CLR -CSP) 

57 ^lOV <<ao4,-(SP) 



.MACRO 


.CVTDT 


•MCALL 


.AMODE 


• IF 


NB,.VAt.2 


.AMODE 


,VAL2 


.ENDC 




tIF 


NB,.VAt.l 


.AMODE 


.VAl-l 


.ENDC 




.AMODE 


.ADDR 


.AMODE 


.CDE 


EMT <a066> 


.ENDM 
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58 fc.MT <a041> 

59 .ENDM 

60 

61 , -MACRO ,fiT9TK ,ADOP 

e2 •'^CAtL .AwnoE 

63 .AMOOF ,AODR 

64 HOV #A04^-(SP) ' 

65 E^T <a041> 

66 .ENDM 
67 

68 .^lACRO ,RUN .RNSUK 

69 .MCALL .AMOOE 

70 .AMOOE ,RNPLK 

71 EHT <a06S> 

72 .ElMDrt 
73 

74 .HACPO .FLUSH ,CDE 

75 .MCALL .AMODE 

76 .AMODF ,CDE 

^ f h. > i '» '■ W-' f -- 

78 .ENDM 

79 

80 > THE MACRO .AHODE ACCEPTS TNE ARGUMENT AND 

81 > AS A PUNCTinN OF THE ADDRESSING MPDE OF 

82 f THE ARGUMENT GENERATES THE APPROPRIATE 

83 ; MOV TO -CSP), 

84 ; ADDRESS MODES THAT ARE TROUBLESOME (£,G, 

85 ; XCSP)) OR UNLIKFLV (E.G. SP) WILL RESULT 

86 J IN A .ERROR TO CMO INCLUDING THE 

87 > VALUE OF THE ADDRESS MODE CF.G, XCSP) 

88 ! IS REPRESENTED AS 000066), THE ARGUMENT ITSELF 

89 > AND THE TEXT "ADDRESSING HQQE ILLEGAL A3 SYSTEM 

90 ? MACRO ARGUMENT". 

91 f 

92 .MACRO .AMODE .ARG 

93 3Pa%A06 

94 .NTYPE ,SYM,.ARG >,SYM»ADDRES3 MODE, 
95 

96 .IP LE,,3YM-a05 

97 HOV ,ARG,-(SP) |R0 TO R5 

98 .MEXIT 

99 .ENDC 
10k) 

101 ,IF E0# •SYMRaO7P'-aO10 

102 .IF LF,,SYm8,a07-a06 

103 MOV .ARG,-(SP) J^RP» TO »R6 

104 .MEXIT 

105 .ENOC 

106 .ENOC 
107 

108 .IF EQ^ .SYMaAO60-AO20 

109 MOV ,ARG,-(SP) ? r#] (R0)+ TO [•1(»7)+ 

110 .MEXIT J #N,##ADDR 

111 .ENDC 
112 

113 ,IF EGf •3Ym8.aO4'^-aO40 

114 .IF LE,,SYM&a07-a05 
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U6 

US 

120 

121 
122 

123 

124 
12$ 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 

i3e 

137 
138 
139 

140 

141 

142 

143 

144 

145 

****** E 

146 



HOV 


,4RG,-CSP) 


.HEXIT 




.ENDC 




,ENOC 




.IF EQ, 


,SyM&A067»A067 


HOV 


.ARG,"CSP) 


,MEXIT 




.ENOC 




.ERROR 


.SYH 


•PRINT 




,ENDM 





; [#]-CR^) TO [•l-'CRS) 
JC^IXCR*^) TO C#1XCR5) 



JADOR AND •ADOR 



f.ARG ADDRESSING HOOE ILLEGAL 
jAS SYSTEM MACRO ARGUMENT. 



J THE MACRO ,CODE SETS UP THE FILEBIOCK 

J WITH THE HOW OPEN CODE. 

? THE ADDRESS OF THE FiLEBLOCK MUST 

f 3E IN A REGISTER (R0 TO R5) 

.MACRO ,COOE .FBLKf.N 
.NTYPE ,SYH,.FBLK 

.IF LE,,SYH-a05 

MOVB #.N#^A02C,F8LK3 rR0 TO R5 

.MEXIT 

.ENDC 



•ERROR ,SYH 

•PRINT 

,ENDM 



|,F8L»< ADORESSIMG MODE ILLEGAL 
?FCP .OPEN FILE BLOCK 



3t 



LNKBLK: 



ERROR RETURN ADDRESS (no buffers) 
or Set to DDE AD CRESS by oINIT 



DATASET LOGICAL NAME * 



DEVICE UNIT # 



# of words to follow 



DEVICE NAME* 



EXjBNSItiLE TO PROVIDE SWITCH SPACE IF 
THE COMMAND STRING INTERPRETER IS BEING 
USED. 

(Size indicated in "# of words to 
f ollow»' ) 



EXAMPLE 
aWORD 
LNKBLK t0 

.RAD50 /ABC/ 
oBYTE 1, 
„ RAD 50 /t>T/ 



*=Packed in 

Radix- 50 format 



LINK BLOCK 



3S. 



^p^ ypsi%s^X 



D^WeiR filOCuE. UXHK- 






PftlOftTTY uEyCu »H«l 



^^^ 



&03Y Pi-^G- Cfl^ » Xdle) 



USER uxMfc Ai:<^e€S^ 



i><t 



>evxce e»x)CK # 



■^Pi^Ff^i^* 



mcmoftY 5oe=PeR *^D5i^ESS 



ST-«T03 



^sglA^ 



[f (A5^ '^^^^^ ^^' 



i>Al f 



iM^e loVf^ ftpJi^ 






fe>rTe Cooi^T 












3^. 



IR 



kOACC^fU H^mC e^ 'P^VTiOSET cor«c«med^ 



•pevxce - K<^or»E. 



'^evxcE. oKcr^ 






PUk-E - 



w^me 



Fli^ exT€.K SI6#4 



OSeA IPCNTXPiXATloN cdD£ 
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Dataset Data Block 

The Monitor has no knowledge of the program's l/O require- 
ments until the program itself identifies these by request- 
ing initialization of the datasets to be used. Hence, as 
stated in the Programmer's Handbook, .INIT must be the first 
function called in each case. In response to such call, the 
Monitor sets up its own control block for the dataset within 
a 16-word buffer unit claimed from free core and stores its 
address in the link-word of the user Link-block. This block 
known as the Dataset Data Block (DDB) , is used thereafter as 
the means by which different Monitor routines pass information 
to each other and also communicate with the driver servicing 
the dataset. It is retained in memory until the program releases 
the dataset from further l/O action, its buffer space is then 
returned to free core. 

The format of the DDB is illustrated on Page 35. The purpose 
of the items is as follows: 

1. Monitor link - enables the Monitor to maintain a 
control chain of the DDB's currently established, 
as illustrated. The chain originates at a DDB 
Chain Origin (DCO) word in the SVT. 

2. Q link - is used to chain the DDB's for datasets 
waiting upon the services of the same device as 
described in the next section. 

3. Priority level - stores the level at which a queued 
call to the driver is made. 

4. Driver routine index - is normally unless a 
driver call is queued: a pointer to the driver rou- 
tine required is then saved here instead. 

5. Driver address - contains the address from which 
the driver associated with the dataset is loaded. 
This also serves to identify the driver when com- 

6. Busy flag - is set by the EMT Handler to the address 

of the program l/o call when accepted. This forces any 
siibsequent call to wait until the current request 
has been satisfied - when it is reset to 0. The address 
of this word is the one stored in the user Link-block 
as the DDB connection to its dataset. 



3f 



7. User line address - in general is used to save the 
second parameter passed by most l/O calls (normally 
the address of a data-block in the program, e.g. . 
Line Buffer in .READ/ -WRITE, TRA -block in .TRAN, 
etc. 

8. Device block - points to the device address of a 
block on a bulk storage medium. 

9. Buffer address - shows the start of a memory area 
for transfer - normally this is an internal Monitor 
buffer; thus this word is also used as an indica- 
tion of the current assignment of such buffer 
(cleared to if none) . 

10. Word count - gives the number of words to be trans- 
ferred by the device as a two's complement value. 

11. Status - is used to direct the driver on the type 
of transfer required, allows the driver to return 
error indicators and stores other control informa- 
tion on a bit-basis. 

12 . Completion return - shows the address at which a 
calling routine requires the driver to return when 
a requested service has been satisfied. 

13. Driver word count - allows the driver to indicate 

(again as two's complement) how many words are not 
transferred because an end of data point is re- 
ached. This word is also used to store a variable 
pointer to the next byte to be processed in the 
internal Monitor buffer. (No device action can be 
underway at this time) . 

14. Byte count - is used during .READ/. WRITE processing 
to control bytes passed between the program line 
and the internal Monitor buffer. 

15. Checksum - is mainly provided for the processing of 
formatted binary data . 

16. DAT pointer - is set during dataset initialization 
to the address of an entry in the Device Assignment 
Table corresponding to the dataset, if such exists 
(see previous section) . 

17. FIB link - connects the DDB to a 16-word buffer ex- 
tension whenever file-structured operations are 
underway on the dataset. It is set to otherwise. 
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PU^ ^. 



TOB ¥ 



€DfO ^ 



^TACK 



PReE 
coee 



fOtKMTU 



S^Fery m^ftj&XrA 



(j^ HefT »V!37€fO- 



"KP6 ^^r PfniR9»e» 






<2J -J 



a^t>r l)bJras«r 



^9 



TRRBUVC s 



3>EVXC€ eAX)CV< # 



u)e«»"D C04>1T (^^e*"t'^V^ 



RjHCTXOr4 /3TPIT0S 



# Off? uAO«»a ♦^oT T^flNSFSK^RC'D 



IS 






I I.I I I 
:^KChxp«. "PtDBdri en: 



1* 



I 



XmAtiB^mR XH 



T^/W-Mock.Forwidr. 



^^. 



OPEN COMMANDS 



UPDATE 

a. HOW OPEN CODE 1. 

b. Contiguous file only 

c. One block is input from contiguous file into Monitor buffer 
or output from Monitor buffer to contiguous file. 

d. 10 allowed: 

(1) .BLOCK IN 

(2) .BLOCK OUT 

OUTPUT 

a. HOW OPEN CODE 2. 

b. Linked File only 

c. Creates starting block of a linked file. 

d. 10 allowed: .WRITE 

EXTENSION 

a. HOW OPEN CODE 3. 

b. Linked file only 

c. Last Block is Input and New Data is Added Starting in the 
Next Free Byte. This and ensuing blocks are written into 
via .WRITE At .CLOSE the Directory is updated to Reflect 
File Size and New Last Block. 

d. 10 allowed: .WRITE 



4 . INPUT 



a. HOW OPEN CODE 4. 

b. Linked or contiguous file. 

c. First block of specified file is read into Monitor buffer 
anticipating .READ. 

d. 10 allowed: 

(1) .READ 

(2) .BLOCK IN 

CONTIGUOUS 

a. HOW OPEN CODE 13. 

b. Contiguous file only. 

c. Opens a previously created contiguous file for sequential 
output (.WRITE) so that you may enter data sequentially into 
physically contiguous blocks. 

d. 10 allowed: .WRITE 
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FILBLK : 



ERROR RETURN ADDRESS 
ERROR STATUS HOW OPEN CODE 

FILE-NAME 
(in Radix-S^") 



EXTENSION (in Radix-SjZf) 
USER IDENTIFICATION CODE 
(spare) PROTECTION CODE 



User File Block 



DDE + 24 
26 



FIB + 




2 
4 
6 
10 
12 
14 
16 
20 
22 
24 
26 
30 
32 
34 
36 



r 



r 



I 



I 

-r 





1? 
t 



(DDB) 

DAT ENTRY ADDRESS 
POINTER TO FIB 



r 



\t^prtAkT\<yf^ 



NEXT BLOCK # 

\ HOW OPEN CODE 

EXTENSION START BLOCK # 

TYPE ' (spare) 

(spare) 

START BLOCK # 

# of BLOCKS 

LAST BLOCK # 

DIRECTORY BLOCK # 

INDEX INTO DIRECTORY BLOCK 

(snare) I PROTECTION CODE 

INTERLEAVE FACTOR 

BIT-MAP POINTER 

BIT-MAP Q LINK 

TEMPORARY 
WORK-SPACE 




File Information Block 



QD 



euKBLWC: 



p.- 



STRTUS 



^UHCTCoH 



Buoc«. Noroe>ER (f'tX^Tt^tm) 



memoRY ^OPFEft «^>Q£5i5 



Ua«^ <»n4 ( uiorc^) 



-* Ptrst ^\ock » 












1 I I i i , 1 , i 









*— OUTPUT 

Xrt^UT 



The. ^UOCK-Uock 



H3 



The RECORD Block 



RECORD Block 



ADDRESS 



RECBLK 



RECBLK: 



^-IJNCTIQN / S TATUS 



BUFFER ADDRESS 



RECORD LENGTH 



HI ORDER. RECORD l,. 
LQ ORDER. RECORD I . 



Figure 3-12 The Record Block 
FUNCTION 

FUNCTION / STATUS WORD 



BIT 



J3 - 



2 - 



Not used 

Record Output - Set by user 

Record Input - Set by user 



-1 _ O _ M/- 



(Following bits set by Monitor) 

9 - Illegal Function 

10 - File is linked or device is not File structured. 

11 - Record requested lies outside the file. 

12 - File not OPEN 

13 - Protect code violation. Incorrect Open 

14 - Not used 

15 - Device parity error 

The user may set only bits 1 or 2; error bits are set 
by the Monitor, and should be tested for by the user 
upon return from the request. The error bits are 
cleared by the Monitor when a .RECRD request is issuea 
and are set as appropriate upon return from the Monitor. 

RECBLK+2 BUFFER ADDRESS 

The address of the user's buffer. The buffer must 
be large enough to contain a record of the length 
indicated in the next word, as the Monitor assumes that 
sufficient space is available and will overlay data 
stored below a buffer of insufficient length. 

RECBLK-f4 RECORD LENGTH 

The number of bytes of a Record. This value, which 
must remain the same for all records in the file, is 
supplied by the user. 

RECBLK+6 High Order - Record Number 
RECBLK+1^ Low Order - Record Number 

This entry identifies the record to be read or 
written. Two words are provided in anticipation of 
files with more than 65,536 records. 

First Record of File is number 0. 
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MODE 



FORMATTED 
ASCII NORMAL 



READ 
TERMINATION 



MAX BYTE 
COUNT 



A CTUAL BYTE 
COUNT 



WRITE 
TERMINATION 



DISCARDED 
CHARACTERS 



BITS 



FORMATTED 
ASCII SPECIAL 



FORMATTED 
BINARY NORMAL 



FORMATTED 
BINARY SPECIAL 






UNFORMATTED ASCII 
NORMAL OR 
SPECIAL 



UNFORMATTED 
BINARY NORMAL OR 
SPECIAL 



FORMATTED 
ASCII PARITY 



UNFORMATTED 
ASCII PARITY 



Line feed, form 
feed vertical 
tab, or max Byte 
count is reached 



Line feed, form 
feed VoT.or 
max Byte count 



i Actual Byte 
j count or maxi- 
I mum Byte count 



Actual Byte 
count 



s Maximum byte 
= count 



Invalid line 
error if max 
Byte before 
terminator 



Invalid line 
error if max 
bytes before 
terminator 



If naxo before 
actual invalid 
line error 



If max before 
actual remain- 
der retained 



. I 



Maximum Byte 



Line feed, form 
feed vertical 
tab, or max 
byte count is 
reached 



Invalid line 
error if max 
byte before 
terminator 



Max count 
plus excess 



sMax count or 

less 

(terminated) 



Max count 
plus excess 



Actual Byte 
count-previous 
terminators out 
as normal 



First termina- 
tor or actual 
byte count 



Actual Byte 
count includes 
words 2+4- 
checksum calc 
+ output 



Max count 
plus excess 



1 Actual Byte 

\ count includes 

i words 2+4- 

I checksum calc 

! + output 



\ Actual byte 
count 
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Actual byte 
count no 
checksum 






See formatted 
ASCII normal 
or special 



Actual byte 
count-previous 
terminators out 
as normal 



Maximum byte 
count 



Actual Byte 
count 



Rubouts and 
nulls excess 
char» 



Rubouts and 
nulls 



After max - 
overlaid in 
last byte 
(Read) 



Nulls only 



8 Bit 
Transfer 



8 Bit 
Transfer 



7 bit 
transfer Bit 

8 set to 



8 Bit 
Transfer 



See formatted 
ASCII normal or 
special 



Nulls only 



Checks for 
even parity 
7 bit Xfer 
BAD 8»1 



8 Bit 
transfer 



l.jZf ABSTRACT 

The TCll DECtape Formatter is a program for marking DECtapes 
on Unit with a standard format of SVS-j^^ blocks of 256]^0 
words each. 

2,0 REQUIREMENTS 

A. Minimum configuration PDP-11 

B. TCll DECtape control and at least one transport. 

C. DECtape (s) 
3,0 LOADING PROCEDURE 

be followed. 
4.0 PRELIMINARY OPERATIONS 

A. Mount a DECtape on Unit 0, wrapping enough turns to insure 
tension - if not enough. Tape will run off reel - Also 
can have hung read. 

B. Set the transport On-line with Write Enable on. 

C. Set the TCll WALL and WRTM switches (up) . Must Remove 
Top Cover . 

5.0 STARTING PROCEDURE 

Load Address 6jZf08 ^"^l press START. 
5 of OPERATING PROCEDURE 

A. Once started the program writes all Timing and Mark Track 
information in one forward pass and then halts at address 
10508. 
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B. If the tape has run off the reel, remount it. Reset the 
WRTM switch (down) and press CONTINUE. The tape will back 
out for three blocks, then turn around and write the com- 
plement obverse of the last block number (11018) in Writeall 
in all data slots until the End Zone is sensed. The tape 
then reverses and writes relevant information in all blocks 
down through in Writeall. 

C. The tape then reverses and alternately searches for each 
block number in sequence then changes to Readall to check 
each block for correct data (,0's). 

D. After all blocks have been verified forward, the tape is 
reversed again and alternately searches for each block 
number in reverse sequence then writes each block to 0's 
in Write Data mode. This insures parity conservation if 
the tape is to be read before being rewritten. 

E. The program then halts at address 2316g. To format another 
tape, perform the operations in section 4.0 then press 
CONTINUE. 

7.0 ERRORS 

7.1 ERROR HALT 

Address 30128 is the common error halt. Press CONTINUE to 
proceed from it. 
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